[UR] Add UR_L0_V2_DISABLE_ZE_LAUNCH_KERNEL_WITH_ARGS debugging variable #20703
+10
−1
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
KFilipek
approved these changes
Nov 20, 2025
ldorau
force-pushed
the
Add_UR_L0_V2_DISABLE_ZE_LAUNCH_KERNEL_WITH_ARGS_debugging_variable
branch
from
876f5c0 to
e96c7cf
Compare
pbalcer
reviewed
Nov 20, 2025
ldorau
had a problem deploying
to
WindowsCILock
GitHub Actions
Failure
ldorau
force-pushed
the
Add_UR_L0_V2_DISABLE_ZE_LAUNCH_KERNEL_WITH_ARGS_debugging_variable
branch
from
e96c7cf to
ce0487c
Compare
kswiecicki
reviewed
Nov 20, 2025
ldorau
force-pushed
the
Add_UR_L0_V2_DISABLE_ZE_LAUNCH_KERNEL_WITH_ARGS_debugging_variable
branch
from
ce0487c to
74c718b
Compare
Contributor
Author
|
CI failure (UR L0v2) is caused by #20683 |
pbalcer
approved these changes
Nov 20, 2025
Add UR_L0_V2_DISABLE_ZE_LAUNCH_KERNEL_WITH_ARGS debugging environment variable to disable calling ZeCommandListAppendLaunchKernelWithArguments(). Signed-off-by: Lukasz Dorau <[email protected]>
kswiecicki
approved these changes
Nov 21, 2025
Contributor
Author
|
@intel/dpcpp-doc-reviewers please review |
sycl/doc/EnvironmentVariables.md
Outdated
| | Environment variable | Values | Description | Adapter Support | | ||
| | -------------------- | ------ | ----------- | --------------- | | ||
| | `UR_L0_V2_FORCE_DISABLE_COPY_OFFLOAD` | Integer | By default, copy operations submitted to any queue can be offloaded to dedicated copy engines. Setting this variable instructs the driver to keep all copy operations on the engine behind the original queue. The default value is 0. | V2 | | ||
| | `UR_L0_V2_DISABLE_ZE_LAUNCH_KERNEL_WITH_ARGS` | Integer | By default, ZeCommandListAppendLaunchKernelWithArguments() will be called when available and possible. Setting this variable instructs the adapter to not call ZeCommandListAppendLaunchKernelWithArguments() and use the old path using ZeCommandListAppendLaunchKernel(). The default value is 0. | V2 | |
Contributor
There was a problem hiding this comment.
Suggested change
| | `UR_L0_V2_DISABLE_ZE_LAUNCH_KERNEL_WITH_ARGS` | Integer | By default, ZeCommandListAppendLaunchKernelWithArguments() will be called when available and possible. Setting this variable instructs the adapter to not call ZeCommandListAppendLaunchKernelWithArguments() and use the old path using ZeCommandListAppendLaunchKernel(). The default value is 0. | V2 | | |
| | `UR_L0_V2_DISABLE_ZE_LAUNCH_KERNEL_WITH_ARGS` | Integer | By default, `zeCommandListAppendLaunchKernelWithArguments()` will be called when available and possible. Setting this variable instructs the adapter to not call `zeCommandListAppendLaunchKernelWithArguments()` and use the old path using `zeCommandListAppendLaunchKernel()`. The default value is 0. | V2 | |
sycl/doc/EnvironmentVariables.md
Outdated
| | Environment variable | Values | Description | Adapter Support | | ||
| | -------------------- | ------ | ----------- | --------------- | | ||
| | `UR_L0_V2_FORCE_DISABLE_COPY_OFFLOAD` | Integer | By default, copy operations submitted to any queue can be offloaded to dedicated copy engines. Setting this variable instructs the driver to keep all copy operations on the engine behind the original queue. The default value is 0. | V2 | | ||
| | `UR_L0_V2_DISABLE_ZE_LAUNCH_KERNEL_WITH_ARGS` | Integer | By default, ZeCommandListAppendLaunchKernelWithArguments() will be called when available and possible. Setting this variable instructs the adapter to not call ZeCommandListAppendLaunchKernelWithArguments() and use the old path using ZeCommandListAppendLaunchKernel(). The default value is 0. | V2 | |
Contributor
There was a problem hiding this comment.
What does "will be called when available and possible" mean? When is it available but it isn't possible to call it?
Contributor
Author
There was a problem hiding this comment.
bool RunNewPath =
!DisableZeLaunchKernelWithArgs && KernelWithArgsSupported &&
(!cooperativeKernelLaunchRequested ||
(cooperativeKernelLaunchRequested && CooperativeCompatible));
if (RunNewPath) {but I think we can remove when available and possible and leave just: By default, zeCommandListAppendLaunchKernelWithArguments() will be called - is it OK for you?
ldorau
had a problem deploying
to
WindowsCILock
GitHub Actions
Failure
ldorau
had a problem deploying
to
WindowsCILock
GitHub Actions
Failure
ldorau
had a problem deploying
to
WindowsCILock
GitHub Actions
Failure
steffenlarsen
approved these changes
Nov 21, 2025
Contributor
steffenlarsen
left a comment
steffenlarsen
left a comment
There was a problem hiding this comment.
The wording of the env var is awfully technical, but I suppose it's no different than some of the others.
ldorau
had a problem deploying
to
WindowsCILock
GitHub Actions
Failure
ldorau
had a problem deploying
to
WindowsCILock
GitHub Actions
Failure
ldorau
had a problem deploying
to
WindowsCILock
GitHub Actions
Failure
ldorau
had a problem deploying
to
WindowsCILock
GitHub Actions
Failure
ldorau
had a problem deploying
to
WindowsCILock
GitHub Actions
Failure
ldorau
had a problem deploying
to
WindowsCILock
GitHub Actions
Failure
ldorau
had a problem deploying
to
WindowsCILock
GitHub Actions
Failure
ldorau
had a problem deploying
to
WindowsCILock
GitHub Actions
Failure
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
5 participants
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Add
UR_L0_V2_DISABLE_ZE_LAUNCH_KERNEL_WITH_ARGSdebugging environment variable to disable callingZeCommandListAppendLaunchKernelWithArguments().